home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 5
/
Gold Medal Software - Volume 5 (Gold Medal) (1995).iso
/
database
/
hpn_100.arj
/
PHONE.DOC
< prev
next >
Wrap
Text File
|
1994-11-03
|
28KB
|
750 lines
┌─────────────────┐
│ │
│ /////////// │
│ │
├─────────────────┤ Huckabey Phone Numbers
│ ■ ■ ■ ■ │ Version 1.00
│┌───┐ ┌───┐ ┌───┐│ November 3, 1994
││ 1 │ │ 2 │ │ 3 ││
│└───┘ └───┘ └───┘│
│┌───┐ ┌───┐ ┌───┐│
││ 4 │ │ 5 │ │ 6 ││
│└───┘ └───┘ └───┘│
│┌───┐ ┌───┐ ┌───┐│
││ 7 │ │ 8 │ │ 9 ││
│└───┘ └───┘ └───┘│ Copyright 1994
│┌───┐ ┌───┐ ┌───┐│ by
││ * │ │ 0 │ │ # ││ James Huckabey
│└───┘ └───┘ └───┘│ software with a heart
│ █ █ █ │
├─────────────────┤
│ │
│ /////// │
│ │
└─────────────────┘
User-Supported Software
User-supported software, which is also known as Shareware,
is an experiment in microcomputer software distribution based on
the following principles:
1. That the value or worth of a program is best judged by the
individual user using the program on his/her own machine.
2. That the creation and distribution of microcomputer software
can be financially supported by users at reasonable cost.
3. That the copying and sharing of software can and is
encouraged.
Anyone may request a copy of a user-supported program by
sending a blank, formatted disk to the author of the program. An
addressed, postage-paid return mailer must accompany the disk (no
exceptions, please). A copy of the program, with documentation on
the disk, will be sent by return mail. The program will carry a
notice suggesting a contribution to the program's author. Making
a contribution is completely voluntary.
Free distribution of software and voluntary payment for its
use eliminates costs for advertising and copy protection schemes.
Users obtain quality software at reduced cost. They can try it
out before buying, and do so at their own pace and in the comfort
of their own home or office. The best programs will survive based
purely on their quality and usefulness.
Please join the experiment. If you share a belief in these
principles, your contribution is requested to help make this
work. Regardless of whether you make a contribution, you are
encouraged to copy and share this program.
Permission to Copy
Individuals, clubs, and other non-profit organizations are
granted permission by the authors to freely copy this program and
documentation and share it with their members, so long as:
1. No price is charged for the software or documentation.
However, a distribution, copying cost or charge for the cost of
the diskette, so long as it is not more than $5.00 total.
2. Club members be informed of the user-supported idea and
encouraged to support it with their donations.
3. The program(s) or documentation are not modified in any way
and they are distributed together.
i
Your Contribution
Please send your contribution, $10 (U.S.) is suggested for
Huckabey Phone Numbers. Please include your name, address,
version number, diskette size and information on where or how you
received your copy of this program. Send to:
James Huckabey
3621-A Fraser Street
Bellingham, WA 98226-2473 U.S.A.
(206) 671-2868 (voice, Pacific)
About Huckabey Phone Numbers
The archive should contain the following files:
FILE_ID.DIZ.......... BBS description file
PHONE.EXE............ actual program
PHONE.DOC............ documentation
PHONE.DAT............ sample database
READ.ME.............. update information
HUCKABEY.TXT......... list of all James Huckabey software
SOFTWARE.TXT......... information on the shareware theme
ARCHIVE.TXT.......... this list of files
The only file needed to run Huckabey Phone Numbers is
PHONE.EXE. The other files are not required by Huckabey Phone
Numbers although it is suggested that you at least load and look
at sample PHONE.DAT. The data it contains can be deleted, or you
can delete the whole file after viewing the two records in it.
Huckabey Phone Numbers is nothing fancy. I wrote the
original program so I could find phone numbers while my computer
was on without having to search for my address book. It is really
not intended for business work although it can be used for such.
Huckabey Phone Numbers does three lines of information per
record. Printing is for all records in the database (PHONE.DAT).
Huckabey Phone Numbers will read in three hundred and fifty
(350) names at a time. The default file it expects to find or
create is PHONE.DAT.
ii
Starting Huckabey Phone Numbers
The database used does not have to be in the same directory
as PHONE.EXE. Huckabey Phone Numbers searches your current path
to find the database. If the database cannot be found it is
written to the current directory or if PHONE.EXE is in the PATH
the database is written where PHONE.EXE is found or a path to its
location is used.
Default means that this is the state when Huckabey Phone
Numbers is first started. In some cases this can be changed once
Huckabey Phone Numbers is running. Keep in mind that if you
change a default in Huckabey Phone Numbers that the next time you
run Huckabey Phone Numbers it uses the default once again.
The First Time
If you are using Huckabey Phone Numbers for the first time
all you have to do is type in 'PHONE' to start Huckabey Phone
Numbers. Program name and command line parameters are not case
sensitive. You may use mixed case, upper or lower case.
Starting examples:
PHONE
phone phone.dat
Phone c:\DATABASE\phone\phone.dat
The examples show that you that you can even add a full
drive and path to the database. You do not need to be in the same
directory as the database as in example #3. If no path is used,
but PHONE.EXE is in your path, the data is written to the
location of PHONE.EXE. If PHONE.EXE is not in your path, and no
path used for database, then the database is written to the
current directory.
With each new record the current database is checked for
name duplications. A duplication is first and last name that
match another first and last name exactly.
Doing Auto Search
If you want the phone number of a particular person when you
start the program you can use:
Example:
PHONE DEBBIE
1
PHONE Debbie Lee
PHONE LEE DEBBIE
PHONE Lee D
These examples show an auto search for Debbie Lee. If there
is only one 'Debbie' in your database you can just use the first
name, but if more than one you need to use at least the first
letter of the last name. Can be firstname-lastname, or lastname-
firstname. Huckabey Phone Numbers finds either format. If a match
is found the first record matching the search criteria is
displayed on the screen. If no match is found the first record in
the database is displayed.
Most prompts in Huckabey Phone Numbers are single key
presses: <A>dd means to press 'A' for add, <Q>uit Program means
to press 'Q' to quit program. Prompt responses are not case
sensitive. The other prompts, inside [ ] brackets require
something like typing in an 'E' or 'e' and pressing <Enter>, some
just pressing <Enter>.
To exit most any input routine you can press the <ESC>
(escape) key. Some responses produce a speaker tone. Examples: If
your search criteria is matched a short tone, if you make an
input error you get a longer tone. There are only two different
tones in Huckabey Phone Numbers.
Whichever your choice if this is a new database Huckabey
Phone Numbers starts in the Edit / Add Records routine. The
screen displays:
Huckabey Phone Numbers | 10-20-1994 | 04:48p
Edit / Add Records to: C:\DATABASE\PHONE.DAT
Record: 1 of 1
_/1:
\2:
3:
4:
Press: line to Edit <1-4>, <A>dd a Record, <D>elete Record,
<N>ext, <P>revious, <S>earch, <H>elp or <Q>uit Routine
The database name displayed on this screen is full
[drive\path\]file name. This is to help prevent adding records to
a wrong database. You might have two databases by the same name
only in different locations. Be reminded that if you have two
2
databases of the same name, and both are on your path, Huckabey
Phone Numbers finds only the first copy or current one if located
in the current directory.
*** Special Note *** If the full path and filename exceeds
forty (40) characters only the filename is displayed.
<A>dd a Record: Press 'A' to add records to the database. If
this is a new database only choices 'A, H and Q' are active
prompt responses. If you are at the 350 maximum records and you
want to add a record you can delete a record and then press
<A>dd. The new entry is put in place of any deleted record and on
exit from the Edit / Add Records routine it is sorted into its
correct position in the database.
Adding records is repeated until you press <ESC> or the
number of records reaches three hundred and fifty (350). Huckabey
Phone Numbers makes a tone at the completion of each new record
in the database. As you enter data one of the following lines is
displayed to show you what the data is for (suggested):
Notice that lines 1: and 2: are marked together in the
columns to their left. This is to remind you that these two lines
are added together by Huckabey Phone Numbers.
1: Firstname (or blank) added to line 2: above. 29
characters maximum (space added when this is added to
lastname).
2: Lastname (or company name) added to line 1: above. 30
characters maximum.
3: Phone Number. 40 characters maximum.
4: Entry Description. 60 characters maximum.
The entry process can be terminated on any line by pressing
the <ESC> key. If this is the first record the record count
remains zero.
Entries #1 (First name) and #2 (last name) are added
together to form actual line number one. Program sorts on entry
#2+entry #1. Line #1 can be blank, but line #2 should not be
blank although it can be. This would make it sort on a blank
entry. Blank entries always appear at the top of the sort order.
As you make each entry there is a line of dashes showing you
the length of the word and '[' ']' on each side of the inputs to
show length limits, which cannot be exceeded.
<D>elete Record: This blanks the current record. Screen
displays:
3
Press <Y>es to confirm deletion of record: 22
Press <Enter> to abort deletion
Where the '22' displayed here is the current record number.
If you press 'Y' the record is deleted. Pressing <Enter> exits
the deletion option. Records that are blank are removed on exit
from the Edit / Add Records routine and on loading the database
at start up. The total record count is adjusted to show a correct
count.
<N>ext and <P>revious change the information on the screen.
Although not displayed in the above prompt the < > or < > display
previous records and < > and < > keys display next records. You
can use either or both sets of arrow keys, but if you use the key
pad make sure <Num Lock> is off. When you reach the first or last
records Huckabey Phone Numbers continues as last changes to first
or first changes to last.
To Edit displayed records you press <1-4> which corresponds
to the line numbers. The screen displays what the line is used
for (suggested), current information if there is any or a line of
dashes to show length.
To remove a single line type in a single space (blank) and
press <Enter>. Huckabey Phone Numbers searches for single space
entries and blanks those lines. If you press <Enter> on a line
without entering any data and the line contains data the existing
information remains unchanged. Records that are all blank lines,
no spaces or other characters, are removed on exit from the Edit
routine and on loading the database at start up.
<S>earch: This is to search the database for a particular
last name, partial name, even just the starting letter or last
name and first, or parts thereof. Entries are not case sensitive.
Huckabey Phone Numbers converts everything to uppercase for
comparisons. Screen displays:
Please Enter Search Criteria or press <Enter> to exit
[ ]
Type in from one letter to as much as lastname+firstname
You can type in Huckabey, Huck, H, Huckabey J, Huckabey
James, James Huckabey, as much (matches down to single records)
or as little (matches more records) as you like. You can type in
your data as firstname lastname or lastname firstname. Huckabey
Phone Numbers ALWAYS searches both formats. This was done to make
4
searches as simple as possible. Some people do lastnames first,
others firstnames first. This way both procedures are covered.
After you enter your information the screen displays
'Searching Database. Please Wait!.' When and if the record, or
matching records is found, the first match is displayed on the
screen.
If no match is found you are returned to the input position
and your search data is displayed on the screen so you can
correct any errors. Use the <BACKSPACE> to erase. To exit you can
erase all data and press <ENTER> or you can press <ESC> at any
time to exit.
<H>elp: Displays several screens of on-line help. Sort of a
quick reference. It also displays information requesting user
contribution.
<Q>uit Routine; Returns you to the main screen and the phone
number information display.
Huckabey Phone Numbers Display Screen (Main Screen)
When returning to the Huckabey Phone Numbers Display Screen
from the Edit / Add Record routine the next record in the
database is displayed if the currently displayed record is blank.
It will not be a blank record when you return to the Phone Number
Display Screen. As already pointed out blank records are removed
from the database.
The information is displayed inside an outline that
represents the four record fields with first and last names added
together.
*** Special Note *** If the full path and filename exceeds
forty (40) characters only the filename is displayed.
Screen displays:
Huckabey Phone Numbers | 10-20-1994 | 04:48p
Database: C:\DATABASE\PHONE.DAT - Records: 27, No: 19
┌─────────────┬───────────────────────────────────────────────┐
│ Name │ James Huckabey │
├─────────────┼────────────────────────────────────────┬──────┘
│ Phone │ 206-671-2868 │
├─────────────┼────────────────────────────────────────┴──────┐
│ Description │ Programmer, James Huckabey Software │
└─────────────┴───────────────────────────────────────────────┘
5
Press: <N>ext, <P>revious, <A>ll Records, <C>odes, <S>earch,
<E>dit Records, <T>ones OFF, <H>elp, <Q>uit Program
<N>ext and <P>revious change the information on the screen.
Although not displayed in the above prompt the < > or < > display
previous records and < > and < > keys display next records. You
can use either or both sets of arrow keys, but if you use the key
pad make sure <Num Lock> is off. When you reach the first or last
records Huckabey Phone Numbers continues as last changes to first
or first changes to last.
<A>ll Records: This prints each record in the database.
Printing is 12 records per numbered page with a line of dashes
separating each record and a ten character margin on the left for
notes or hole punching. Names are printed last name, first name.
Screen displays:
Printing 27 Records. Please Wait!
When printing is finished you are returned to the Phone
Number Display Screen. There is no further action on your part.
<C>ode: The screen displays:
Type in printer code and press <Enter> or <E>xit Routine
[ ]
See your printer manual for decimal codes, separate by space
This might be something like typing in the following '27 69'
(Epson and other some other printer code for emphasize on) and
pressing <Enter>.
If your format was not valid the screen displays: 'Invalid
Entry!' and you are returned to the input position. If input was
a valid format the screen displays: 'Sending code(s) to printer',
which may just flash, and when finished you are returned to the
Phone Number Display Screen.
If there is a printer error you are returned to the input
position and your printer code(s) is displayed on the screen so
you can correct any input or printer errors. Pressing <ENTER>
resends the data to the printer. Use the <BACKSPACE> to erase. To
exit you can erase all data and press <ENTER> or you can press
<ESC> at any time to exit.
<S>earch: This is to search the database for a particular
6
last name, partial name, even just the starting letter or last
name and first, or parts thereof. Entries are not case sensitive.
Huckabey Phone Numbers converts everything to uppercase for
comparisons. Screen displays:
Please Enter Search Criteria or press <Enter> to exit
[ ]
(one letter or as much as last name first name)
You can type in Huckabey, Huck, H, Huckabey J, Huckabey
James, or even James Huckabey. As much (matches down to single
records) or as little (matches more records) as you like.
After you enter your information the screen displays
'Searching Database. Please Wait!.' When and if the record, or
matching records is found, the first match is displayed on the
screen. If no match is found you are returned to the input
position.
Remember that Huckabey Phone Numbers always finds the first
match. If you are looking for a last name of 'Lee" and there is a
record with 'Lee' for a first name and the last name starts with
something less than an 'L' that Huckabey Phone Numbers finds the
first name 'Lee' and ends. Searches are better if you supply more
than just one name unless that name is unique in the database.
'Huckabey J' is better than 'Huckabey' and 'Huckabey James' is
best if that is the record you are searching for.
<E>dit Records: This is the Edit/Add Records option outlined
in Starting Program for first time, etc.
<T>ones: Sound is turned ON or OFF depending on the current
state. Default is OFF.
<H>elp: Displays several screens of on-line help. Sort of a
quick reference. It also displays information requesting user
contribution.
<Q>uit Program: Screen displays:
Press <Y>es to confirm program termination
Press <Enter> to abort termination
If you press 'Y' Huckabey Phone Numbers is terminated and
7
returns you to the DOS prompt or calling program. Pressing
<Enter> returns the main prompt. This is just to prevent
accidental exits from Huckabey Phone Numbers. One tends to get
used to pressing 'Q' or <ESC> and some of us have heavy hands.
(grin) Your original system colors are restored prior to exiting
Huckabey Phone Numbers.
8
Format for Database
Example of a database viewed or edited from DOS shown here
with line numbers to help with understanding. Any editor or word
processor that can write DOS text files (ASCII) can be used:
<-Actual positions in database(s)
<-Record information (4 line set)
<-Actual start of data per line
-------------------------------------------------------
1 (1) John
2 (2) Doe
3 (3) 555-555-5555
4 (4) Plumber
5 (1) Jane
6 (2) Doe
7 (3) 515-515-5151
8 (4) Florist. Has great assortment of plants and flowers!
9 (1)
10 (2) Johnson Contractors
11 (3) 505-212-5555
12 (4) Home Construction. Built our new garage.
13 (1) James
14 (2) Huckabey Software
15 (3) 206-671-2868
16 (4) Programmer
All you have to keep track of is each four line set. This
file can be edited with any external program if that is what you
want to do or is easiest for you. Just make sure you keep the
four lines per record format for the database. Actually you can
write and maintain the database externally and only use Huckabey
Phone Numbers for the actual printing. This is the reason I write
out the data as a standard text file (ASCII with one entry per
line).
******* WARNING *******
If you do edit records via another program you must honor
the 350 record limit of Huckabey Phone Numbers (1400 lines).
Additional records are ignored by Huckabey Phone Numbers if you
exceed this limit. Also if your four (4) line records get out of
sets that throws off all the following records in the database
from that point.
The only reason I added this information to the
documentation is to show an optional way to edit, add or remove
records other than from inside Huckabey Phone Numbers. This is
the way my original program ran. I added all my records with a
9
text editor and of course I made my share of errors by not
counting lines correctly when adding new records, removing or
editing. (grin)
10